home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 16 / CU Amiga Magazine's Super CD-ROM 16 (1997-10-16)(EMAP Images)(GB)[!][issue 1997-11].iso / CUCD / Graphics / Ghostscript / gs503_000.readme < prev    next >
Text File  |  1997-09-09  |  8KB  |  175 lines
  1. Short:    Ghostscript5.03 68000 bin
  2. Author:   GS(Aladdin)/Amiga(Olaf Barthel/Steffen Opel)/Port(me)
  3. Uploader: JoopvandeWege@mail.mococo.nl
  4. Type:     gfx/show
  5. Requires: gs503data.lha
  6.  
  7. This is the Amiga port of Ghostscript5.03. Ghostscript is a Postscript
  8. interpreter with support for Level 2 PS and PDF. This release includes
  9. most popular printers and fileformats including an updated Amiga display
  10. driver.
  11.  
  12. Features:
  13. Ghostscript supports three Amiga specific devices (but see below for ILBM):
  14.     amiga           Amiga Workbench window
  15.     amiga_custom    Amiga custom screenmodes
  16.     amiga_printer   Amiga printer.device
  17. (amiga_printer seems to have problems, please use one of the internal ones)
  18. (redesign done by Steffen Opel opel@sto.isdn.uni-mannheim.de)
  19.  
  20. The device 'amiga' opens an Intuition window on the Workbench screen to
  21. display the image. Its usage should be pretty obvious.
  22.  
  23. The device 'amiga_custom' opens a Customscreen to display the image. This 
  24. allows any Display Mode available in the screenmode preferences to be used
  25. with Ghostscript too.
  26.  
  27. The device 'amiga_printer' is a convenient alternative for the printer devices
  28. provided by Ghostscript itself. It facilitates standard Amiga printing via the
  29. Workbench printer drivers and respects most settings in the graphics 
  30. preferences as described in the Workbench documentation.
  31.  
  32. All three devices are supporting -g and -r as described in 'use.txt'.
  33.  
  34. Ghostscript currently has only limited support for IFF ILBM files:
  35.     amiga_ilbm    IFF ILBM file format
  36.  
  37. The device 'amiga_ilbm' works like any other Ghostscript raster file or 
  38. printer device (i.e. pbm), see 'Choosing the output device' above on how 
  39. to specify an output file.
  40. It supports dithered grayscale only and is not portable to other platforms 
  41. because it uses iffparse.library. A portable implementation with color 
  42. support is currently under development.
  43.  
  44. Please be sure to read the Amiga section in Use.txt for details (can be
  45. found in the directory 'doc').
  46.  
  47. This port requires:
  48. - An  Amiga  equipped  with  an mc68000 CPU or any successor CPU model and
  49.   Kickstart 2.04 or higher.
  50. - Approx. 4.7 MBytes of hard disk space available.
  51. - A  minimum  of 1 MByte of chip memory, depending on what you want to do
  52.   with  the  interpreter.  Printer output requires at least 2 MBytes of
  53.   contiguous memory (any memory, not necessarily chip memory).
  54. - A bunch of Postscript/Ghostscript fonts.
  55.  
  56. Comments/Suggestions/Bugs to:
  57. JoopvandeWege@mail.mococo.nl
  58. Please use a Subject field with the name 'GS503' in it.
  59. Please direct all mail to me except when you're 100% sure it is a GS
  60. problem then you can use the Aladdin email address.
  61.  
  62. Joop van de Wege
  63.  
  64.  
  65. Getting Ghostscript.
  66. Download the data archive, gs503data.lha
  67. It contains all needed data in one directory
  68.  
  69. This archive contains the base mc68000 binary which should run on plain
  70. A1200, A3000, A4000-030, A4000 and any A500/A600/A1000/A2000 machine with
  71. a mc68020/30/40/60 installed and enough RAM. On my machine
  72. (A3000 + Merlin) it uses 150Kb Chip and 1.5Mb Fast.
  73. Expect it to use more if the psfile is big/complex or when displaying PDF
  74. files and when using 256color modes for the Workbench.
  75.  
  76. How to use Ghostscript.
  77. - Unpack the archive gs503data.lha to a suitable HD with enough room (~3.5M).
  78.   for example 'Work:'.
  79.   A directory 'Ghostscript' will be created and all files needed are found
  80.   within this directory (Work:Ghostscript).
  81. - Unpack one of the special binary archives to the same HD and the executable
  82.   will automatically be placed in the same directory (Work:Ghostscript/gs_000).
  83.   Further do:
  84.   - Assign Ghostscript: Work:Ghostscript
  85.   - path Ghostscript: add
  86.     (Optionally, rename the binary gs_xxx to 'gs')
  87.     Now you can call 'gs' from anywhere with or without arguments. If you add
  88.     the above fragment (Assign ... add) to your s:user-startup then it will
  89.     available everytime you start your computer
  90. - Unpack gs501fonts-std.lha, if you don't have a set of good quality
  91.   postscript fonts. The advantage of using this archive is that you don't
  92.   need to mess with the file 'Fontmap'. The fonts will be placed in 
  93.   'Work:Ghostscript/fonts'.
  94. Or if you already have postscript fonts, do the following:
  95.   - Assign PSFonts: to your postscript font directory (anywhere)
  96.   - create file PSFonts:FONTMAP with at least the following entries:
  97.  
  98. % fontmap aka Fontmap
  99. % ----------------------------------------------------------------
  100. /Times-Roman                    (ptmr.gsf)      ;
  101. /Times-Italic                   (ptmri.gsf)     ;
  102. /Times-Bold                     (ptmb.gsf)      ;
  103. /Times-BoldItalic               (ptmbi.gsf)     ;
  104.  
  105.     It does not matter, which font files are assigned (see below)
  106.  
  107.   - entries within the FONTMAP file at PSFonts: must follow the
  108.     scheme described below:
  109.  
  110.           /Fontname             (Filename)      ;
  111.  
  112.     for example
  113.  
  114.           /Helvetica            (Helvet.pfb)    ;
  115.  
  116.     which means, the corresponding files must actually exist.
  117.     But one also my substitute Fonts symbolically by other fonts,
  118.     like for example:
  119.  
  120.           /Helvetica_Bold       /Helvetica      ;
  121.  
  122.   - the variables in ENV: and ENVARC: must look as follows:
  123.  
  124.       Variable          Content        Remark
  125.  
  126.       GS_FONTPATH                      do not set: delete this one!!
  127.       GS_LIB            PSFonts:
  128.       GS_OPTIONS                       set it, but keep it empty
  129.       GS_DEVICE         amiga          for example (its the default)
  130.  
  131.  
  132. See the 'Ghostscript/docs/use.txt' directory for more information, like
  133. commandline options. Some notes:
  134. - Watch out for case sensitivity when using commandline options, -sOutputFile
  135.   is not equal to -soutputfile !!!!!
  136. - Set your stack high enough, 32000 bytes should do it (stack 32000).
  137.  
  138. Some very useful commandlines with comments in ():
  139. gs -h (outputs small help on most important arguments, and lists all availble
  140.        output devices)
  141. gs (gs opens window on WB and use its palette, use 256color WB if possible,
  142.     there is a problem with NewIcons, it looks like all palette entries are
  143.     reserved by NewIcons so GS will only display in B/W if you use NewIcons)
  144. gs -sDEVICE=png16m (uses the built-in PNG support instead of window on WB)
  145. gs -sOutputFile=ram:output%02d.png -sDEVICE=png256
  146.    (output to files numbered ram:output01.png/ram:output02.png/etc using
  147.     the PNG format (8bit))
  148. gs -r120 (use 120dpi as resolution instead of built-in 72, uses heaps of
  149.           memory at high values)
  150. Arguments useful for PDF files (and ps documents conforming to DSC ?)
  151. gs -dFirstPage=pagenumber (starts on the given page of the document)
  152. gs -dLastPage=pagenumber (Stops after the given page of the document)
  153. See use.doc/Switches for a complete overview of what is available.
  154.  
  155. (taken from 'new-user.txt')
  156. PDF encryption
  157. --------------
  158.  
  159. A user outside the U.S. has created code that allows processing of encrypted
  160. PDF files.  Unfortunately, current U.S. export control laws don't allow
  161. redistribution of this code from a site in the U.S., even though it's freely
  162. available to anyone anywhere in the world from its author's site, so you'll
  163. have to get this code from:
  164.  
  165.         http://www.ozemail.com.au/~geoffk/pdfencrypt/pdf_sec.ps
  166.  
  167. If that doesn't work, try:
  168.  
  169.         http://www.ozemail.com.au/%7Egeoffk/pdfencrypt/pdf_sec.ps
  170.  
  171. The patch consists entirely of PostScript code, so it can be added to a
  172. running version of Ghostscript -- you don't have to recompile anything.  It
  173. is a single file that replaces the file pdf_sec.ps in the standard
  174. Ghostscript fileset (Ghostscript:data/pdf_sec.ps).
  175.